home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Internet Tools 1995 April / Internet Tools.iso / infoserv / gopher / Unix / GopherTools / glog / glog35.readme < prev    next >
Encoding:
Text File  |  1994-12-12  |  2.8 KB  |  78 lines
  1.                           Gopher Log Analyzer 3.5
  2.                      Andy Wick
  3.               awick@csugrad.cs.vt.edu
  4.  
  5. What is it:
  6.    glog will allow you to analyze your gopher log files.  Hopefully
  7. supplying you will useful reports/plots/histograms.  It is fairly 
  8. easy to use, with plenty of options.  It can generate almost any kind 
  9. report that you would want.  This is probably going to be the last 
  10. version of glog, at least by me.  There are lots of other nice utilities 
  11. that do this very same thing.  Plus I am applying to graduate schools now.
  12.  
  13. It should compile with any standard ansi compiler, and now it should even 
  14. work under VMS. (thanks Dennis R. Sherman)
  15.  
  16. To compile: (assuming gcc)
  17.    1) Edit glog35.c and look at the configuration section.  There are
  18.       four options that you can play with, but the defaults should
  19.       be fine.
  20.    2)
  21.       gcc glog35.c -o glog
  22.  
  23.  
  24.  glog -h will display the options :).
  25.  
  26. Examples: 
  27.  
  28. % glog35 -sn -gO < gopher.log | more
  29.      Print out a domain graph sorted by the domain name field to stdout
  30.  
  31. % glog35 -pT < gopher.log | more
  32.      Generate a gnuplot file with type information
  33.  
  34. % glog35 -aY -sH -rD -i gopher.log -o gopher.out
  35.      Generate a report sorted by the reverse number of hits, 
  36.      average the data as if there was a years worth, and save it
  37.      to a file called gopher.out
  38.  
  39. Tested on:
  40.  Amiga DOS, Solaris 2.3, Ultrix 4.2A
  41.  gcc 2.3.3 and higher was used on all platforms.
  42.  
  43. Features:
  44.  * The command line is parsed as the reports/plots/histograms are generated, 
  45.    so that it is possible to change options for each separately.  But options
  46.    are NOT reset for each new one.
  47.  
  48.  * Produces reports/plots/histograms on the [D]ata, [H]osts, day of the [W]eek,
  49.    data [T]ypes, T[I]me, D[O]main and [M]onth/date sorted (ie. sorted by date).
  50.  
  51.  * Can sort reports by name forward/backward or by hits forward/backward
  52.  
  53.  * Produces detailed reports on any thing you can produce a normal
  54.    report for.  Yes, you can even produce a host detail report of a 
  55.    hosts report. (But it doesn't do you much good :)
  56.  
  57.  * Change the width of the reports.
  58.  
  59.  * You can specify the filename for plots, it defaults to gopher. (The 
  60.    program appends a .dat, and and .run to the name)
  61.  
  62.  * You can request as many plots as you want. (But remember to change the
  63.    filename or you will overwrite the last plot)
  64.    
  65.  * The program is now a lot easier to add new types of reports to, you
  66.    only need to add 3 short routines, a variable, and edit 2 functions.
  67.    (Well, maybe it is simple for me. :)
  68.  
  69.  * Can select starting and ending month. (Sorry no wrap around)
  70.  
  71.  * Average/Estimating can be done with the -aX option.  Possible values
  72.    for "X" are [E]verything (default), [Y]ear, [M]onth, [W]eek, [D]ay, and [H]our
  73.  
  74. Where to get:
  75. - boombox.micro.umn.edu
  76.      /pub/gopher/incoming (until the move it to)
  77.      /pub/gopher/Unix/GopherTools/glog
  78.